Anular tender - Fire spark

Anula un tender que todavía no está PAID, CANCELLED ni REFUNDED. La llamada es idempotente por idempotency_key. Un tender pagado se reembolsa.

Requiere un access token de Storefront API de Intercambio de token. El pedido ya debe estar colocado.

En @fire-spark/storefront, llama order.voidTender(tenderId, reason).

Parámetros de ruta

Parámetro	Requerido	Descripción
`id`	Sí	Identificador externo del pedido
`tenderId`	Sí	Identificador del tender

Cuerpo de la solicitud

Campo	Requerido	Descripción
`idempotency_key`	Sí	10–64 caracteres. Reúsalo para reintentar la misma anulación.
`reason`	No	Hasta 500 caracteres

curl -X POST "https://firespark.cloud/api/storefront/v1/orders/ord-48291/tenders/tnd-card-1/void" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "idempotency_key": "void-9f3c1a20b4" }'

Respuesta

Devuelve 200 con el pedido. El estado del tender queda CANCELLED cuando el proveedor acepta la anulación. Un resultado NEEDS_REVIEW igual anula el tender y deja el caso para revisión. Un rechazo devuelve 502 y no cambia el tender.

Respuestas de error

Estado	Descripción
`404`	Pedido o tender no encontrado
`409`	El pedido sigue `OPEN`, o el tender ya está pagado, anulado o reembolsado
`502`	El proveedor rechazó la anulación